home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / exprot35.zip / EXPROT.DOC < prev    next >
Text File  |  1990-11-29  |  12KB  |  232 lines
  1.       EXPROT Ver. 3.5 EXTERNAL PROTOCOL INTERFACE
  2.                           by
  3.                   Luis R. Cáceres, Jr.
  4.                  8711 S.W. 20th Terrace
  5.                     Miami, FL 33165
  6.  
  7.  EXPROT is an external protocol manager designed to be used with
  8.  such popular terminal programs as Telix, Commo, and Pro-Comm Plus.
  9.  It is meant to be invoked by being named as the editor in your
  10.  terminal program's configuration file, by means of a key macro,
  11.  connect-independent script, or by inclusion as a SINGLE external
  12.  protocol.
  13.  
  14.  EXPROT is pre-programmed to enable downloading and uploading of
  15.  files using Zmodem (Fosberg's version), Ymodem (also Fosberg's
  16.  version), Lynx, Puma, and Jmodem.  Versions 2.5 and 2.6 also sup-
  17.  ported Super8k and Super8K-G, but this protocol, though one of
  18.  the fastest, turned out to be difficult and erratic, and is sup-
  19.  ported by only a handful of BBSs.  Version 2.7 dropped Super8K
  20.  and added HyperP. Version 3.00 dropped HyperP and added Zmodem
  21.  Auto Download (see below), Xmodem, 1k-Xmodem, Ymodem Batch, 
  22.  Megalink and SEAlink.  The option for BiMenu has also been dropped,
  23.  as has that of the editor, both present in previous versions.
  24.  
  25.  EXPROT is a single-file program, with no overlays or separate
  26.  setup utilities. It must be configured, but right from within,
  27.  by answering five simple questions: what is your modem port,
  28.  its highest speed, EXPROT's own path, the download path, and the
  29.  upload path.  EXPROT takes your word at face value and does no
  30.  error trapping when being configured, so be careful and accurate
  31.  in your answers.
  32.  
  33.  If EXPROT cannot find its configuration data file, it will prompt
  34.  you for its pathname rather than force you to reconfigure. This
  35.  avoids problems when you have shelled out of your terminal program,
  36.  wandered about your hard disk, and then returned ('EXIT') to the
  37.  terminal without bothering to CD\ back to its directory first. It
  38.  also makes EXPROT easier to use under DESQview. You don't even have
  39.  to tell DESQview about EXPROT. Just give your terminal some 56K
  40.  more of RAM than it uses by itself, and practice invoking EXPROT
  41.  once before making a connection.
  42.  
  43.  EXPROT's Zmodem command includes the option for "resume" or
  44.  comparison crash recovery. If there's no incomplete file in the
  45.  target directory, the resume command will not interfere, and the
  46.  specified files will be normally transferred in their entirety.
  47.  There is also a toggle to enable or disable Zmodem-90 "MobyTurbo".
  48.  If YOUR DSZ is an older one without MobyTurbo, leave it off, or
  49.  your Zmodem transfers will abort with an error message. Whether the
  50.  host's Zmodem has MobyTurbo or not is inconsequential to you.
  51.  Otherwise, it will be to your advantage to toggle it on.
  52.  
  53.  Also in regards to Zmodem and the other DSZ-based protocols, EXPROT
  54.  sees to it that they put downloads in your specified D/L directory,
  55.  EVEN IF YOUR DSZ IS NOT REGISTERED.  This is accomplished by the
  56.  simple expedient of making the D/L directory the current one when
  57.  DSZ is chosen, and invoking DSZ remotely.  When the transfer is
  58.  complete, and before returning you to your terminal, EXPROT
  59.  changes back to its own drive and directory.  This is completely
  60.  transparent to you.
  61.  
  62.  Once configured, using EXPROT is so simple and intuitive that we
  63.  regard any instructions as unnecessary.  You just select your
  64.  protocol from the menu, press D or U (for Download or Upload) and
  65.  provide a filespec if uploading, or, if downloading, only if you
  66.  chose Xmodem, 1k-Xmodem, or Jmodem.
  67.  
  68.  If you give only a filename when prompted for a filespec, EXPROT
  69.  will look for it in the upload path; but you can override this by
  70.  providing a full pathname. In other words, you can upload files NOT
  71.  located in your upload directory if you tell EXPROT exactly where
  72.  they are.
  73.  
  74.  If you are DOWNLOADING with Xmodem, 1K-Xmodem, or Jmodem, and you
  75.  enter a full path when prompted for a filespec, the protocol will
  76.  not proceed, but end with an error message. Downloads MUST go to 
  77.  the d/l directory, and this CANNOT be overridden.
  78.  
  79.  For Megalink transfers, EXPROT automatically lowers the rate, if it
  80.  was set higher, down to the maximum supported by the protocol,
  81.  which is 9600. Or, if you prefer, you can manually override the
  82.  default modem speed by pressing the letter `S' and entering the new
  83.  speed.  This MUST be done if your connection to the host is at a
  84.  rate lower or higher that the one shown on EXPROT. Overriding in
  85.  this manner will only affect that particular transfer, and no
  86.  changes will be written to the configuration file. The manual
  87.  override is ineffective and unnecessary with all the other protocols
  88.  supported by EXPROT, since they autodetect the baud rate from the
  89.  carrier signal.
  90.  
  91.  Telix Users:  There are two ways to install Exprot. Using it as
  92.  -----------   an editor called by pressing Alt-A, or adding it
  93.  as a script-based external protocol with EXPROT.SLC (supplied in
  94.  this acrhive). Press Alt-O and select Protocol Options. In the 
  95.  latter case, if you select Upload (PgUp or Alt-S), Telix will 
  96.  prompt you for a filespec, and will pass your entry to EXPROT. 
  97.  EXPROT will then automatically go into upload mode and 
  98.  acknowledge the filespec; but you must still choose the 
  99.  protocol. Zmodem Auto is not available in this mode, for obvious 
  100.  reasons. Configuring is not available either, but toggling 
  101.  MobyTurbo and changing baud rate are active options.  
  102.  
  103.  Telix users will not only gain easy access to Puma, Lynx,
  104.  Megalink, and Jmodem, but also to the faster Zmodem-90
  105.  "MobyTurbo" if their DSZ is so equipped (see below).
  106.  
  107.  ProComm Plus Users: May be added as a regular, batch-file
  108.  ------------------  driven external protocol, or via the
  109.  Alt-J key macro, which is the recommended way. Zmodem DOES 
  110.  accept more than one filespec through EXPROT.
  111.  
  112.  Commo Users:  Any macro is suitable, but the one we find most
  113.  -----------   convenient and which makes Commo feel much more
  114.  like the internal-protocol equipped terminal programs is the
  115.  following one (for ver. 4.22):
  116.  
  117.   EXPROT Interface {pgd} {exec d:\dir\exprot.com} {}
  118.  
  119.  This macro will bring up Exprot almost instantly when PgDn is
  120.  pressed, enabling you to erase all the downloading and upload-
  121.  ing macros from the sample Commo.MAC (except any that drive
  122.  protocols not supported by EXPROT), and release all the
  123.  respective key combinations for macros that perform other 
  124.  chores.
  125.  
  126.  TSR communications programs do not require any installation.
  127.  Just give the host the transfer command, return to DOS, and
  128.  invoke EXPROT. If PC-Tools Dektop has NOT been loaded TSR, give
  129.  the host the transfer command, shell out (or exit if you are
  130.  short of RAM), and invoke EXPROT.
  131.  
  132.  Notes on Zmodem Auto:
  133.  
  134.  When you intend to use Zmodem Auto, do NOT complete the transfer
  135.  command to the HOST from the terminal program and then proceed to
  136.  Zmodem Auto via EXPROT. Invoke Exprot first, select Zmodem Auto,
  137.  press enter to induce the host's prompt, and THEN give the host the
  138.  d/l command.  If you only started the transfer command from the
  139.  terminal, but the transfer has not yet begun, you may complete the
  140.  command after from within DSZ.  However, if the actual transfer has
  141.  started, you must abort it by pressing Ctrl-X repeatedly; then press
  142.  Enter to get the host's prompt, and THEN repeat the download command.
  143.  
  144.  While in Autodownload, you can also start a Ymodem download by
  145.  pressing F3, but you CANNOT upload from this mode. If you want to
  146.  upload, press F1 or Alt-N to exit, and return to your terminal.
  147.  Read DSZ's documentation for further information.
  148.  
  149.  NEW IN EXPROT 3.5
  150.  -----------------
  151.  EXPROT 3.5 corrects a few bugs which made EXPROT act as if a 
  152.  protocol had been chosen if the space bar or other inappropriate 
  153.  key were pressed by mistake or accident. Now, each menu or choice 
  154.  should respond only to its authorized keypresses. Also, 3.5
  155.  corrects "file not found" errors when more than one filespec was 
  156.  entered for Puma and Lynx batch uploads. If you enter a long list
  157.